home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr29 / dualos2.zip / README.TXT < prev    next >
Text File  |  1995-02-28  |  27KB  |  653 lines
  1. Welcome to the Demo version of the IBM DualStor Backup 
  2. Program for OS/2 Version 2.0!
  3.  
  4. All operations of the DualStor for OS/2 program are enabled with this
  5. Demo version EXCEPT the Restore operation.  You can Select the
  6. Restore operation but after you enter the Restore parameters, you
  7. will receive a message indicating the Restore operation is disabled.
  8. To install this Demo version, insert the DualStor for OS/2 diskette
  9. in a 3.5" floppy drive and enter 'x:setup' where x=your 3.5" floppy
  10. drive designator (for example, a:setup) from an OS/2 window.
  11. After DualStor for OS/2 is installed and you have Shutdown OS/2 and
  12. rebooted, double-click on the DualStor folder on the Desktop and then
  13. double-click on the DualStor icon to star the DualStor application.
  14.  
  15. We hope you like DualStor!  If you would like to purchase DualStor for
  16. OS/2 you can call Options by IBM at 1-800-426-7299 (US Only) or IBM
  17. Direct at 1-800-465-7999 (Canada Only).  
  18. You may also be interested in purchasing the DualStor 450 Tape Drive which
  19. can store up to 450 meg of data when using a Sony QIC-wide tape QW5122XL
  20. and level 2 compression (data dependent).
  21.  
  22. DualStor part numbers:
  23. 11H1568  DualStor for OS/2 version 2.0 (software only)
  24. 11H1505  DualStor for OS/2 version 2.0 and DualStor 450 Tape Drive
  25. 11H1594  DualStor for DOS/Windows version 2.0 (software only)
  26. 11H1504  DualStor for DOS/Windows version 2.0 and DualStor 450 Tape Drive
  27.          (hardware, software, & 1 Sony QIC-wide QW5122XL tape cartridge)
  28. 11H1571  Upgrade from DualStor for DOS/Windows 1.0x
  29. 11H1549  Upgrade from DualStor for OS/2 1.0x
  30.  
  31. The following is the README that ships with the product.
  32. ----------------------------------------------------------------------
  33. TABLE OF CONTENTS
  34.   1 - DualStor Installation Notes
  35.   2 - DualStor Installation and PMTAPE
  36.   3 - DualStor Stand-Alone Restore
  37.   4 - DualStor Execution
  38.   5 - DualStor and OS/2
  39.   6 - DualStor Job (Parameter) Files
  40.   7 - DualStor and Networks
  41.   8 - Compatibility with Other Software and Hardware
  42.   9 - DualStor 2.0 Changes from Versions 1.x
  43.  10 - Miscellaneous
  44.  11 - Errorlevel Return Codes for Command Files
  45.  
  46. ----------------------------------------------------------------------
  47.   1 - DUALSTOR INSTALLATION NOTES
  48. ----------------------------------------------------------------------
  49.  
  50. *Installing Into the Same Directory as a Previous Version of DualStor*
  51.  
  52. If you are going to install DualStor for OS/2 into the same directory
  53. as a previous version of DualStor for OS/2 then follow these steps
  54. prior to your installation.  These steps will avoid conflicts with current
  55. DualStor for OS/2 files and ensure all of the latest DualStor for OS/2 
  56. files are installed correctly:
  57. 1.  If AutoTape is currently installed:
  58.     a.  Open the OS/2 Startup folder from the Desktop.
  59.     b.  Move the mouse over to the AutoTape icon and single click on mouse
  60.         button 1 to select the AutoTape icon.
  61.     c.  Single click on mouse button 2 to display the AutoTape pop-up menu.
  62.     d.  Move the mouse to 'Delete' and click on mouse button 1 to
  63.         delete the current AutoTape icon.
  64. 2.  Use a text editor to modify your config.sys file in the following manner:
  65.     a.  Locate the DualStor 'DEVICE=x:\x\IP22IDRV.SYS' statement (it is most
  66.         likely at the bottom of your config.sys).
  67.     b.  Insert 'REM ' in front of 'DEVICE' (this will cause this statement
  68.         to be 'remarked out' and not executed the next time config.sys
  69.         is executed).  (If you prefer you could delete this line instead of
  70.         remarking it out).
  71.     c.  Locate the DualStor 'RUN=x:\x\IP2XMN.EXE' statement (it is most
  72.         likely at the bottom of your config.sys).
  73.     d.  Insert 'REM ' in front of 'RUN' (this will cause this statement
  74.         to be 'remarked out' and not executed the next time config.sys
  75.         is executed).  (If you prefer you could delete this line instead of
  76.         remarking it out).
  77.     e.  Save and file these changes.
  78. 3.  Shutdown your OS/2 system and reboot it.
  79. 4.  You are now ready to install DualStor for OS/2 in the same
  80.     directory as a currently installed DualStor for OS/2 using the
  81.     normal installation procedure.
  82.  
  83. If you receive a window during installation indicating that DualStor
  84. found an older version of IBM1FLPY.ADD or IBM2FLPY.ADD installed on
  85. your system you need to select the 'Install new file' button.  This
  86. newer module is required to run DualStor properly under OS/2 2.x.
  87.  
  88. ----------
  89. *Boot-up Problems After DualStor Installation*
  90.  
  91. If after installation, your system has an error during boot-up (such
  92. as hanging on the 'Minicartridge tape driver.  Version x.xx' message),
  93. edit your config.sys file using a text editor and move the DualStor
  94. 'DEVICE=x:\x\IP22DRV.SYS' and 'RUN=x:\x\IP2XDMN.EXE'
  95. statements (which will be at the bottom of config.sys) to the top
  96. of config.sys and re-boot your system as a possible solution.
  97.  
  98. ----------
  99. *DualStor and Migrating Windows Applications to OS/2*
  100.  
  101. If you have DualStor for Windows installed on your system and 
  102. you install OS/2, do not migrate the DualStor for Windows to the OS/2
  103. Desktop.  DualStor for Windows will not work properly in the Win-OS/2
  104. session.  If you did migrate DualStor for Windows to the OS/2 Desktop,
  105. you should delete the DualStor for Windows folder.
  106.  
  107. ----------------------------------------------------------------------
  108.   2 - DUALSTOR INSTALLATION and PMTAPE
  109. ----------------------------------------------------------------------
  110.  
  111. If you have PMTAPE installed on your system in the '\PMTAPE' directory,
  112. during the DualStor installation you will receive a message indicating
  113. a previous tape driver was found.  If you choose to have the PMTAPE
  114. driver removed, your '\PMTAPE' LIBPATH and PATH entries and RUN and
  115. DEVICE statements will be removed from your CONFIG.SYS.  You will
  116. not receive this message if PMTAPE is installed in a directory other
  117. than '\PMTAPE'.
  118.  
  119. DualStor and PMTAPE can co-exist on your system.  If you have them
  120. both installed make sure the first entry in your LIBPATH and PATH
  121. statements in CONFIG.SYS is '.;' and if you run DualStor or PMTAPE
  122. from an OS/2 command prompt you must run them from the directories
  123. in which they are installed.  However, if you are using AutoTape and
  124. you have both PMTAPE and DualStor installed on your system you will
  125. need to delete both entries in CONFIG.SYS and then enter the full working
  126. directory for each in the AutoTape command field.
  127.  
  128. ----------------------------------------------------------------------
  129.   3 - DUALSTOR STAND-ALONE RESTORE
  130. ----------------------------------------------------------------------
  131.  
  132. If you are going to use the Stand-Alone restore function as decribed
  133. in the Getting Started manual pages 1-7 and 1-8 and User's Guide
  134. manual pages 4-10 through 4-13 please be aware of the following
  135. information:
  136.  
  137. 1.  After performing an SR and rebooting the system, DualStor for OS/2
  138.     may be open.  This is normal and is caused by the
  139.     'SET AUTOSTART=PROGRAMS' line in config.sys.  Make sure all the
  140.     open programs are closed and re-opened before use.
  141.  
  142. 2.  If you are using an IBM model 9595 with OS/2 2.0 you must have
  143.     the OS/2 2.0 Service Pak XR06100A installed.
  144.  
  145. 3.  MakeSR does not support XDF-formatted diskettes.
  146.  
  147. 4.  If you are using an IBM 9553, 9556, or 9557, or any AT bus, EISA bus,
  148.     or ISA bus system you need to obtain a newer version of the OS/2 file
  149.     IBM1FLPY.ADD than the one described above under 'DualStor
  150.     Installation and OS/2 2.0' before making the Stand-Alone restore
  151.     diskettes as described in the Getting Started manual on
  152.     pages 1-7 and 1-8.  You ONLY need this module if you are going to
  153.     use the Stand-Alone restore function for OS/2 2.1 and OS/2 2.11.
  154.  
  155.     To obtain the updated file you may download it from the IBM PCCBBS
  156.     (PC Company Bulletin Board System); or you may contact the IBM OS/2
  157.     Support Center at 1-800-992-4777 and ask for APAR PJ12214 if you
  158.     have OS/2 2.1 and for OS/2 2.11 you need files XR0F034.1DK and
  159.     XR0F034.2DK.
  160.  
  161.     The fix will be mailed to you via regular first class mail.
  162.  
  163.     1. To download from PCCBBS, dial into the PCCBBS at (919) 517-0001.
  164.        (You need a modem/Communications software to download the fix
  165.         electronically).
  166.  
  167.     2. Enter your first and last name when prompted.
  168.  
  169.     3. Enter your password when prompted. Note: Choose a password
  170.        that you will remember because you will need to specify
  171.        it the next time you log onto the PCCBBS.
  172.  
  173.     4. You will next be asked a series of questions. Please provide
  174.        information when prompted.
  175.  
  176.     5. To fast forward to the Main Menu, enter "N" and press the enter
  177.        key when PCCBBS NEWS screens are displayed.
  178.  
  179.     6. Once at the "IBM PCC Public BBS New User Main Menu" screen, you
  180.        are ready to download the fix.
  181.        a.  To download the fix for OS/2 2.1 or earlier enter:
  182.  
  183.            D PJ12214.EXE
  184.  
  185.           Specify communications information when prompted.
  186.           This is a self exploding file. Once the file has been downloaded
  187.           and installed on your system hardfile, insert a blank diskette
  188.           in drive A of your system, enter PJ12214 A: This will unpack
  189.           the fix files to diskette. Read the README.1ST to install the
  190.           fix.
  191.  
  192.       b.  To download the fix for OS/2 2.11 enter:
  193.  
  194.           D XR0F034.1DK
  195.           D XR0F034.2DK
  196.  
  197.     7.  If you are a Middle East, Europe, or Africa customer, to
  198.         obtain the updated file you may download it from the IBM
  199.         PCCBBS (PC Company Bulletin Board System); or you may
  200.         contact the IBM OS/2 Support Centre and ask for OS/2 2.1
  201.         APAR PJ12214 and for OS/2 2.11 you need files XR0F034.1DK
  202.         and XR0F034.2DK.
  203.  
  204. 5.  After you have run MAKESR and made your SR diskettes, you should
  205.     immediately boot the SR diskettes to make sure there are no problems.
  206.     If you do experience an error during boot-up (such as hanging on the
  207.     'Minicartridge tape driver.  Version x.xx' message), edit the config.sys 
  208.     file on SR disk #2 using a text editor and move the DualStor
  209.     'DEVICE=x:\x\IP22DRV.SYS' and 'RUN=x:\x\IP2XDMN.EXE' statements
  210.     to the top of config.sys and re-boot your system as a possible
  211.     solution.
  212.  
  213. 6.  There is an undocumented option, SR /ds, you can enter to see
  214.     the filenames scroll to the screen as they are being restored.
  215.  
  216. 7.  If you are using SR to restore a Dual Boot system, in order for
  217.     the system to be able to boot DOS, you must do the following
  218.     once you are able to use the hard drive to boot your OS/2 system:
  219.  
  220.     a.  At the OS/2 prompt, type CD\OS2.
  221.  
  222.     b.  Type Boot /DOS.
  223.  
  224.     c.  Place a DOS Startup diskette in the diskette drive.
  225.  
  226.     d.  Enter Y at the prompt to reboot the system.
  227.  
  228.     e.  At the A:\ prompt, type SYS C:
  229.  
  230.  8.  If you are using SR to restore a Boot Manager system, in order for
  231.      the system to be able to boot DOS, you must do the following
  232.      once your hard drive is restored.
  233.  
  234.     a.  Place a DOS Startup diskette in the diskette drive.
  235.  
  236.     b.  Re-boot the system.
  237.  
  238.     c.  At the A:\ prompt, type SYS C:
  239.  
  240.  
  241. ----------------------------------------------------------------------
  242.   4 - DUALSTOR EXECUTION
  243. ----------------------------------------------------------------------
  244.  
  245. *Undocumented Copy/Paste Capability*
  246.  
  247. In the Session Logs window, the Control menu includes a copy
  248. capability not documented in the User Manual. To copy a session log,
  249. select Copy to Clipboard from the Control Menu. The text of the
  250. session log will be copied to the clipboard and can be pasted into
  251. another application that has a paste command.
  252.  
  253. ----------
  254. *Backing up Files and EXCLUDEP.CFG
  255.  
  256. The file EXCLUDEP.CFG located in the DualStor install directory
  257. contains a list of system files that DualStor excludes from the
  258. backup.  It is not necessary for these files to be backed up.
  259.  
  260. One of the files in this list is EA DATA. SF.  This file contains
  261. the Extended Attributes for the files on a FAT file system.  During
  262. backup the extended attributes for a given file are extracted from
  263. EA DATA. SF and stored on the tape with the file.  During the Restore
  264. operation the attributes are restored to EA DATA. SF correctly.
  265. If EA DATA. SF were backed up and restored, the restore of these
  266. extended attributes could adversely affect files on the system
  267. that were not backed up at the time of the original backup.
  268.  
  269. ----------
  270. *Incremental vs. Differential Backup Methods*
  271.  
  272. The difference between Incremental and Differential backups
  273. is that the Incremental method will reset the archive bits and the
  274. Differential method will not reset the archive bits.  Both methods
  275. will back up the same files from your hard disk.  Checked files
  276. that have the archive bit set on will be backed up by both methods.
  277.  
  278. ----------
  279. *AutoTape Command Prompt*
  280.  
  281. When entering a command in the AutoTape command box, be sure to use
  282. the extension of the file being used so that the operation will work
  283. properly. For example:
  284.  
  285.     DUALSTRP.EXE FULL-CDE.TPF
  286.  
  287. ----------
  288. *~BEX Files*
  289.  
  290. Files that begin with ~BEX are temporary files used by DualStor. If
  291. you see one of these files when DualStor is not running, you can
  292. delete them. ~BEX files will be found either in your TEMP directory or
  293. your DualStor directory.
  294.  
  295. ----------
  296. *Ignoring Drives in DualStor*
  297.  
  298. You can tell DualStor to ignore specified drives, if you have drives
  299. that are creating error messages or speed problems when you run
  300. DualStor. For example, if you have a computer with a single floppy
  301. drive (drive A:), you can have DualStor ignore your non-existent B
  302. drive.  You may also want to use this setting to tell DualStor to
  303. ignore both A: and B: drives so that they do not appear in your
  304. DualStor Drives window.  The default Drives selection would then
  305. always be your C: drive.
  306.  
  307. To do this, add the following statement to your CONFIG.SYS file.
  308.  
  309.         SET IRSKIPDISK=ab
  310.  
  311. You can list as many drive letters as you want, putting no spaces
  312. between them, for example, IRSKIPDISK=abcd (to ignore your A:, B:,
  313. C:, and D: drives).
  314.  
  315. ----------------------------------------------------------------------
  316.   5 - DUALSTOR AND OS/2
  317. ----------------------------------------------------------------------
  318.  
  319. *Error Message "User INI File Corrupt"*
  320.  
  321. Restoring OS/2 system files to your hard disk may give you an error
  322. message stating: "The workplace desktop could not be located. The user
  323. INI file or hardfile may be corrupt." The message appears because OS/2
  324. sees system files momentarily not synchronized. Ignore this message.
  325. Your restore should complete without any problems.
  326.  
  327. ----------------------------------------------------------------------
  328.   6 - DUALSTOR JOB (PARAMETER) FILES
  329. ----------------------------------------------------------------------
  330.  
  331. *Using Parameter Files from PS2Tape and PMTape*
  332.  
  333. If you have parameter files created for PS2Tape or PMTape, they will
  334. work with DualStor by copying them into the DualStor directory.
  335. Parameter files are now called job files and can be created more
  336. easily using options in the DualStor Jobs menu. Be sure that your
  337. existing parameter files have names different from the five job files
  338. created during DualStor installation (FULL.TPF, DIFFR.TPF, INCR.TPF,
  339. REST.TPF, and TAPEINFO.TPF), so you don't overwrite any of them.
  340.  
  341. Because of enhancements to job file capabilities, some of the syntax
  342. for job file commands has changed.  Your existing parameter files will
  343. still run, but first you should review Appendix B in your User Manual
  344. for detailed information on the new job file command syntax. 
  345.  
  346. ----------
  347. *Logging a DualStor Operation*
  348.  
  349. All DualStor operations, including operations launched from job files,
  350. are logged in a DualStor Session Log. If you want to create a log file
  351. in a specific location with a specific name, open the job file using a
  352. text editor and add the following command:
  353.  
  354.    /l log_name
  355.  
  356. The /l command is a job file "option" available in backup and restore
  357. modes. The log file will be saved in your DualStor directory or you
  358. can specify a full path. For example:
  359.  
  360.    /l c:\bulogs\backup.log
  361.  
  362. The log file will list files that were included and/or excluded from
  363. the operation depending on the logging settings specified in DualStor.
  364. DualStor creates the log file after you exit the program. See Appendix
  365. B in the DualStor User Manual for more information on job file
  366. editing.
  367.  
  368. ----------
  369. *Mode Variables*
  370.  
  371. There is only one mode variable allowed in each Job file (i.e. *.tpf)
  372. Mode variables are !backup, !restore, !init, !util, and !shortcuts.
  373.  
  374. ----------
  375. *Encryption and Password Options*
  376.  
  377. The Encryption and Password options are not available for use with
  378. Job files.  Therefore, if you check the Encryption option in your
  379. Settings pull-down, Backup defaults window it will not be enabled
  380. (it will be grayed out) when you save a Job file.
  381.  
  382. ----------
  383. *Date Specification*
  384.  
  385. When using the '/d' option in a DualStor Job file you must have a
  386. space on both sides of the date_spec value.
  387.  
  388. -----------------------------------------------------------------------
  389.   7 - DUALSTOR AND NETWORKS
  390. ----------------------------------------------------------------------
  391.  
  392. *LAN Server 3.0*
  393.  
  394. LAN Server 3.0 users must perform local backups of Domain Controllers
  395. by selecting the drive letter of their local OS/2 boot drive. 
  396.  
  397. For example, if
  398.  
  399.           D: is the local OS/2 boot drive
  400.           Q: is the alias of the path D:\*.*
  401.  
  402. you must select drive "D:" for the backup.
  403.  
  404. ----------
  405. *Novell Volume Restrictions*
  406.  
  407. Novell volume restrictions will only be backed up if you use QIC tapes
  408. with the DualStor file system or you use Servo (AccuTrak) tapes.
  409. Volume restrictions are not backed up using QIC tapes with the 
  410. QIC-Compatible file system (QIC-80 and QIC-113).  See your DualStor
  411. User's Guide for more information on file systems.
  412.  
  413. ----------------------------------------------------------------------
  414.   8 - COMPATIBILITY WITH OTHER SOFTWARE AND HARDWARE
  415. ----------------------------------------------------------------------
  416. *Intel Premiere II PCI Motherboard*
  417.  
  418. If you have a Pentium system with the Intel P90 motherboard
  419. (Premiere II PCI, codename Plato) and you are experiencing
  420. slow transfer rates, 'DMA Overruns', or excessive shoe-shining
  421. (tape spins backward and forward continuously) when performing
  422. DualStor backup operations, you should first call the Intel Bulletin
  423. Board at 916-356-3600 and search for 'BIOS' for information that
  424. could resolve these problems.
  425.  
  426. ----------
  427. *National Semiconductor Floppy Controller DP8473*
  428.  
  429. If DualStor for OS/2 detects this floppy controller on your
  430. system, DualStor will use a maximum transfer rate of
  431. 500Kbps (vs. 1Mbps).  This is due to the floppy controller
  432. not containing a FIFO.
  433.  
  434. ----------
  435. *DualStor and 5.25" External Diskette Drive*
  436.  
  437. If you have a 5.25" external diskette drive device driver loaded
  438. via your OS/2 config.sys (for example, driver EXT5DD.SYS), the
  439. DualStor Scan function will not execute properly.  To avoid this
  440. problem add the following line to your config.sys:
  441.  
  442.     SET IRSKIPDISK=x
  443.  
  444. where 'x' = the drive letter designator of your 5.25" external
  445. diskette drive.
  446.  
  447. ----------
  448. *Compatibility with QICstream*
  449.  
  450. QICstream backup software cannot read DualStor backup sets that are
  451. compressed.
  452.  
  453. ----------
  454. *Compatibility with Colorado Memory System Backup Software*
  455.  
  456. CMS's Colorado Backup software cannot read DualStor backup sets that
  457. are compressed.
  458.  
  459. ----------
  460. *4100MC and IBM Model 9577*
  461.  
  462. The 4100MC controller card in an IBM Model 9577 will cause DualStor
  463. to work improperly. To avoid this problem, connect your tape drive to
  464. your computer's floppy controller rather than the 4100MC card. See
  465. your tape drive's installation guide for more information.
  466.  
  467. ----------
  468. *SCSI Hard Drives and the Adaptec 1540 Controller*
  469.  
  470. If you are using:
  471.  
  472.     * a tape drive with a floppy controller AND
  473.     * a SCSI hard drive with an Adaptec 1540 controller,
  474.  
  475. you must set the IROPT environment variable. To set IROPT, enter the
  476. following command at the OS/2 prompt before you start up DualStor:
  477.  
  478.         SET IROPT=Y
  479.  
  480. Note that the Y must be in upper case. You can also add the same
  481. statement to your CONFIG.SYS.
  482.  
  483. ----------------------------------------------------------------------
  484.   9 - DUALSTOR 2.0 CHANGES FROM VERSIONS 1.x
  485. ----------------------------------------------------------------------
  486.  
  487. *Default Backup Set Names*
  488.  
  489. If you mark specific directories and/or files for backup as opposed to
  490. marking an entire hard drive, the default backup set name will be
  491. "Partial-X" where 'X' is the drive designator of the hard drive on
  492. which the directories and/or files marked for backup reside.  DualStor
  493. versions 1.x used a default backup set name of "Full-X".
  494.  
  495. ----------
  496. *Column Headers*
  497.  
  498. Column headers were added to the tops of the file windows.  These
  499. column headers identify the column by name (ex. "Name", "Date",
  500. etc.).  The columns can be sized by dragging the separator line
  501. between each column (the separator line to the left of "Name"
  502. is not enabled).  Click the left mouse button on any column to sort
  503. the entire list by that column.
  504.  
  505. ----------------------------------------------------------------------
  506.   10 - MISCELLANEOUS
  507. ----------------------------------------------------------------------
  508.  
  509. *Verify after Backup*
  510.  
  511. It is a good practice to check the 'Verify after Backup' option on when
  512. selecting your Backup Parameters.  This will cause DualStor to
  513. perform a byte-by-byte comparison between the data backed up on
  514. the tape and the data on the hard drive increasing your confidence
  515. in the backup.  It may, however, double the time of your backup.
  516. If you want to set this option on permanently for all of your backups,
  517. simply select the Settings pull-down, Backup..., and check the
  518. 'Verify after Backup'.
  519.  
  520. ----------
  521. *Setting RESTARTOBJECTS in Config.sys*
  522.  
  523. It is a good practice to add the following statement in your Config.sys
  524. file.
  525.  
  526.          SET RESTARTOBJECTS=STARTUPFOLDERSONLY
  527.  
  528. This will only start objects in your startup folder and your startup.cmd
  529. during boot-up.
  530.  
  531. ----------
  532. *Passwords*
  533.  
  534. If you are using the QIC file system with the Password option, only 8
  535. characters are significant even though DualStor will accept 15
  536. characters.  All 15 characters are significant when using the DualStor
  537. file system.
  538.  
  539. ----------
  540. *Hardware Compression*
  541.  
  542. The DualStor User's Guide shows a Hardware Compression radio button
  543. on the Backup Set Parameters windows but you will not see it in the
  544. application itself as DualStor does not support any tape drives that
  545. support Hardware compression.
  546.  
  547. ----------------------------------------------------------------------
  548.   11 - ERRORLEVEL RETURN CODES FOR COMMAND FILES
  549. ----------------------------------------------------------------------
  550.  
  551. You can use ERRORLEVEL to check the return codes of a DualStor
  552. tape operation if you are using DualStor job files through an OS/2
  553. command file(filename.CMD).
  554. The values returned by DualStor in ERRORLEVEL are as follows:
  555.  
  556. 0  = No errors, successful completion
  557. 1  = No tape cartridge in drive
  558. 2  = Tape is full, cannot write
  559. 3  = Tape is write protected
  560. 4  = Mount failed or incompatible tape
  561. 5  = Invalid command line arguments
  562. 6  = Fatal disk error
  563. 7  = Not enough memory available to run
  564. 8  = No tape drive present
  565. 9  = User aborted operation
  566. 10 = Fatal tape error
  567. 11 = Critical verify failure, backup set deleted
  568. 12 = Internal software error
  569. 13 = Disk full on restore
  570. 14 = Disk full in \temp directory
  571. 15 = No files selected
  572. 17 = Non-critical verify warning (Verify miscompares seen in Session log)
  573.  
  574. The following line is an example of the contents of a job
  575. file to retension the tape first.  The 'Do not wait for errors'
  576. option is set on.  Let's call the job file RETEN.TPF:
  577.  
  578. !util /w 0 /r
  579.  
  580. The following line is an example of the contents of a job file
  581. to backup the C: drive. It will scan checked files, not wait
  582. on error, name the backup set and backup the C: drive.  Let's call
  583. the job file MYBACKUP.TPF:
  584.  
  585. !backup /m /w 0 /n "MYBACKUP" /s C:\*.*
  586.  
  587. The following OS/2 command file is an example of how you might
  588. use the DualStor return codes and the above DualStor job
  589. files.  Let's call the command file TAPEOPS.CMD:
  590.  
  591. rem --------Beginning of Sample Command program-------------------
  592. @echo off
  593. @echo.
  594. rem Log Retension tape start message to TAPEOPS.LOG file
  595. echo Execute DualStor job file to retension tape >>.\tapeops.log
  596. DUALSTRP reten.tpf
  597. rem next statement checks for errorlevel = 1 or greater
  598. if errorlevel 1 goto :checkrc
  599. echo Retension tape successful >>.\tapeops.log
  600. rem
  601. rem Log Backup start message to log file
  602. rem Execute DualStor job file to backup C: drive >>.\tapeops.log
  603. DUALSTRP mybackup.tpf
  604. rem next statement checks for errorlevel = 1 or greater
  605. if errorlevel 1 goto :checkrc
  606. echo Backup of C: successful >>.\tapeops.log
  607. goto :end
  608. rem
  609. rem Check which error DualStor found and go process the error
  610. :checkrc
  611. if errorlevel 16 goto :nomsgfl
  612. if errorlevel 15 goto :noflsckd
  613. if errorlevel 14 goto :diskfull
  614. if errorlevel 13 goto :diskfull
  615. if errorlevel 12 goto :softerr
  616. if errorlevel 11 goto :verfyerr
  617. if errorlevel 10 goto :tapeerr
  618. if errorlevel 9 goto :userabrt
  619. if errorlevel 8 goto :nodrive
  620. if errorlevel 7 goto :memerr
  621. if errorlevel 6 goto :diskerr
  622. if errorlevel 5 goto :invcl
  623. if errorlevel 4 goto :inctape
  624. if errorlevel 3 goto :wptape
  625. if errorlevel 2 goto :tapefull
  626. if errorlevel 1 goto :notape
  627. rem
  628. rem  Here are examples for a few of the return codes:
  629. rem
  630. :inctape
  631. echo Either the mount failed or the tape is incompatible,
  632. echo Check the tape condition and restart TAPEOPS.CMD
  633. pause
  634. goto end
  635. rem
  636. :notape
  637. echo There is no tape in the drive, please insert a tape and
  638. echo restart TAPEOPS.CMD
  639. pause
  640. goto :end
  641. rem
  642. :end
  643. echo End of TAPEOPS.CMD >>.\tapeops.log
  644. rem ------------End of Sample Command program----------------
  645.  
  646.  
  647.  
  648. TAPEOPS.CMD, RETEN.TPF, and MYBACKUP.TPF would all reside in the
  649. directory where DualStor is installed.  The above example would
  650. be executed by typing 'TAPEOPS.CMD' on the command line at the DualStor
  651. directory OS/2 prompt (\DUALSTOR\TAPEOPS.CMD).
  652.  
  653.